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PREFACE 
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not covered again in this publication. 
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CHAPTER 1. INTRODUCTION 



This 



publi cati on 



describes the 
fac TT vt y b f the 
archi tecture 



i nterpreti ve-executi on 
System/370 extended 
(370-XA). The interpretive-execution 
facility serves the special purpose of 
improving the efficiency with which a 
specialized component of a control 
program can oversee the execution of 
programs in a virtual-machine environ- 
ment. Execution of these programs is 
achieved through a combination of capa- 
bilities provided by the real machine 
while in the interpretive-execution mode 
and of services supplied by supporting 
programs. This publication describes 
the capabilities provided by the 
machine, which include the complete 
handling of many aspects of the archi- 
tecture of an interpreted machine, as 
well as the presentation of status in 
convenient forms for support-program 
processing where complete machine handl- 
ing is not provided. 

The interpreted machine is called the 
guest. Facilities appropriate to the 
mode of the guest machine, either 
System/370 mode or 370-XA mode, are 
provided when the real machine is opei — 
ated in the interpretive-execution mode. 
The interpreted machine is said to 
constitute a virtual machine. The term 
host i s used to refer to the real 
machine and to the control 
both manages real machine 
provides services to the 
or machine. The guest and 
execute guest and host programs, 
tively. 



program which 
resources and 
guest program 
host machines 
respec- 



The instruction START INTERPRETIVE 
EXECUTION (SIE) is provided for invoking 
the i nterpreti ve-executi on mode. 
Execution of SIE causes the machine to 
enter the interpretive-execution mode 
and to commence execution of the guest 
program. Certain operations encountered 
in the guest cannot be performed in the 
interpretive-execution mode, and some 
may have been optionally designated to 
cause interpretive execution to be 
discontinued. In these cases, the 
machine exits from the interpretive- 
execution mode, SIE execution is 
completed, and the instruction in the 
host program that follows SIE is desig- 
nated as the next instruction to be 
executed. This process is called intei — 
ception, and it includes saving the 
state of the guest in an area called the 
state description and providing informa- 
tion about the reason for the 
i ntercepti on. 

The machine may also exit from the 
interpretive-execution mode by intei — 
rupting SIE execution. This would 
occur, for example, for a host I/O 



interruption. Execution of SIE follows 
the rules for" interrupt i ble 
instructions; that is, the parameters in 
the state description for continuing the 
execution of the guest are updated in 
such a way that when the old host PSW i s 
loaded, causing SIE to be reexecuted, 
execution resumes at the interrupted 
point in the guest. 



The operand of the 
called the state de 
description specifi 
to be interpreted, 
be used to represen 
the contents of s 
addressable gues 
addresses of rela 
bits for controlli 
optional facilities 
i ng information 
interception, and 
other aspects of th 



SIE instruct 
scription. Th 
es the type of 
the host sto 
t guest main s 
erne of the p 
t registers, 
ted control 
ng the operat 
, areas for d 
concerni ng 

i nf ormati on 
e operation. 



l on is 

e state 

system 

rage to 

torage, 

rogram— 

"the 

tables, 

i on of 

i splay- 

an 

about 



Two methods of representing guest main 
storage are provided. In the pageable- 
storage mode, guest main storage 
consists of a portion of a host address 
space. That is, guest absolute 
addresses, to which an offset is added, 
are treated as host virtual addresses. 
In the preferred-storage mode, guest 
main storage consists of the first 
portion of host main storage. That is, 
guest absolute addresses are treated 
unmodified as host absolute addresses. 
With both methods, guest address- 
translation mechanisms, including 
dynamic address translation and prefix- 
ing, are provided by the machine. 

The various forms of storage have been 
described in other publications in terms 
of levels. Real (host) main storage has 
been called level-1 storage. In the 
pageable-storage mode, host virtual 
storage used to represent guest main 
(real) storage has been called level-2 
storage. And guest virtual storage has 
been called level-3 storage. This 
publication does not use those terms. 

Guest storage-key protection is 
provided, with guest keys set as the 
real keys for the real storage assigned 
to the guest. All other protection 
mechanisms are provided as well for the 
guest. In addition, host page 
protection is applicable to guest refei — 
ences to guest main storage in both the 
System/370 mode and 370-XA mode in the 
in the pageable-storage interpretive- 
execution mode. 

A separate control area, called the 
ref erence-and-change-preservati on (RCP) 
area, is provided for retaining the 
values of the change and reference bits 



that are separa 
guest and to the 
ual 4K bytes of 
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pageable- storage 
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Timing facilities are, for the most 
part, fully interpreted for the guest. 
A guest time-of-day-clock value is 
obtained by adding a constant found in 
the state description to the value of 
the host TOD clock. The guest CPU-timer 
and guest clock-comparator values are 
specified in the state description, with 
the function of these facilities 
provided by the machine while it is in 
the interpretive-execution mode. Most 
instructions associated with the timing 
facilities are executed in the same 
manner in the interpretive-execution 
mode as when the machine is not in that 
mode. When the System/370 mode is spec- 
ified, the interval timer is also 
maintained by the machine and very neai — 
ly reflects the time spent in the 
interpretive-execution mode. Guest 
interruption processing associated with 
guest timing facilities is performed in 
part by the machine. The operation of 
host timing facilities is not affected 
by operation of the machine in the 
interpretive-execution mode. 



Most instructions 
same manner i n 
execution mode as 
not in that mode. 



are executed in the 

the i nterpreti ve- 

when the machine is 

However, a number of 



instructions are given special treatment 
in the interpretive-execution mode. 
This includes instructions that are: 

• Not interpreted. Interception is 
mandatory for these instructions. 
This group includes the I/O 
instructions and other infrequently 
occurring privileged instructions. 

• Handled differently in the inter- 
pretive-execution mode This is 
generally because of special char- 
acteristics of the interpretive- 
execution environment. This group 
includes the storage-key-handling 
i nstructi ons. 

• Interpreted as invalid when the 
System/370 i nterpreti ve-execut i on 
mode is specified. This group 
includes those instructions which 



are available in the 370-XA mode 
but not available in the System/370 
mode. 

• Conditionally interpreted depending 
on the setting of control bits. 

Later sections of this publication 
describe the instructions for which 
special handling is provided. 

Provisions for handling guest I/O 
include the following: 

• Most I/O instructions cause inter- 
ception, with information about the 
instruction provided in the state 
description at interception. 

• A means is provided for recording a 
pending guest I/O interruption, and 
causing an interception when the 
guest PSW is enabled for I/O intei — 
ruptions. A similar mechanism is 
provided for guest external inter- 
rupti ons. 

Interpretive execution can provide the 
effect of a guest shared-main-storage 
multiprocessing configuration. Multiple 
host processors can be simultaneously 
employed in this activity. Each guest 
CPU is defined by a separate state 
description, with each state description 
specifying the same guest main storage 
and RCP areas. An additional area, 
called the system-control area (SCA), is 
used for control purposes; the same SCA 
is designated by each state description 
of a guest multiprocessing 
conf i gurati on. 
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CHAPTER 2. START INTERPRETIVE EXECUTION INSTRUCTION 
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Processing in the interpretive-execution 
mode continues until either an intei — 
ception or host interruption occurs. 
Interception occurs when conditions are 
encountered in the guest which cannot be 
handled in the interpretive-execution 
mode or for which special assistance is 
supplied by a program in the host. 
Interception is accomplished by updating 
the state description to indicate the 
cause of the interception and to reflect 
the current state of the guest, by leav- 
ing the interpretive-execution mode, and 
by causing the execution of START INTER- 
PRETIVE EXECUTION to be completed. Host 
interruptions are accomplished by updat- 
ing the state description to reflect the 
current state of the guest, by leaving 
the interpretive-execution mode, and by 
setting the instruction address in the 
old host PSW to designate the inter- 
rupted START INTERPRETIVE EXECUTION 
instruct! on. 

Host PSW bits 16 and 32 must be zero and 
one, respectively; otherwise, a 
special-operation exception is recog- 
nized, and instruction execution is 
suppressed. 

The second-operand address is a real 
address, and accesses to the second- 
operand location are not subject to 
key-controlled protection. A specifica- 
tion exception is recognized, and 
instruction execution is suppressed, if 
the operand is not designated on a 
256-byte boundary, or if bits 1-19 of 
the operand address are zeros or are 
equal to the host prefix. Host 
low-address protection is not applied to 
guest references to guest storage. (The 
location of guest storage within host 
storage is specified in the state 
descri pti on. ) 



Host P E R for i n s truct i o n f etchi ng 
applies to the fetch of START INTERPRE- 
TIVE EXECUTION itself and is indicated, 
if applicable, as for other interrupti- 
ble instructions. Host PER monitoring 
for general-register alteration is not 
applied, nor is host PER monitoring for 
storage alteration applied to the state 
description, the RCP area, the SCA, or 
the host storage area used for guest 
storage, while execution takes place in 
the interpretive-execution mode. Host 
PER does not apply to the execution of 
guest instructions. 



Host tracing does 
operati ons. 



not apply to guest 



A serializing function and a check- 
point-synchronization function are 
performed on entrance to and exit from 
the interpretive-execution mode. 



Condi ti on 
unchanged. 



Code: 



The code 
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Program Excepti ons : 

Addressing (fetch and store operand 

2) 
Operation (the instruction is not 

installed or provided on this 

CPU) 
Page translation (RCP area and 

guest storage area) 
PER (I-fetch) 
Privileged operation 
Segment translation (RCP area and 

guest storage area) 
Special operation (PSW bit 16 is 

not zero and PSW bit 32 is not 

one) 
Specification (operand-2 address 

bits 24-31 are not zeros, or 

bits 1-19 either are zeros or 

are equal to the prefix) 
Translation specification (RCP area 

and guest storage area) 



Programmi ng Notes 



Addressing and page-protection 
exceptions for the RCP area and 
guest storage area are not reported 
to the host but instead are 
reported to the guest. Host trans- 
lation exceptions for these areas 
are reported to the host. 

Low-address protection does not 
apply to the state description and 
RCP areas for SIE since these 
addresses are checked to ensure 
that they are not in the low- 



address area. In the preferred- within the guest storage area nor 

storage mode, the storage to match the address of the SCA. 

designated by the host prefix The RCP and SCA are designated by 

register is neither permitted to be fields in the state description. 
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CHAPTER 1^ STATE DESCRIPTION 



The START IMERPRETIVE EXECUTION. ( SIE ) 
instruction specifies an operand in host 
real main storage called the state 
description. On entry to the 
interpretive-execution mode, the state 
description contains the initial state 
of the guest CPU. On exit from the 
interpretive-execution mode, the state 
of the guest CPU is stored in the state 
description. Various control and status 
fields concerned with the operation of 
interpretive execution are also provided 
in the state description. 

After entry has been made to the inter- 
pretive-execution mode, changes to the 
state description by the channel or by 
another CPU do not necessarily affect 
the interpretive execution or the asso- 
ciated guest program. Also, fetch 
references to the state description by 



another C PU or by the chann el do not 
necessarily obtain the current values of 
the associated guest registers and may 
result in unpredictable operation. An 
exception to this unpredictability rule 
occurs for the fields labeled "inter- 
vention requests" and "TCH control." 
The bits in these fields may be set to 
ones by an interlocked update by one CPU 
while the fields are concurrently being 
used to control interpretive execution 
in another CPU, with assurance that the 
change will be observed by the CPU in 
the interpretive-execution mode. The 
contents of these fields are said to be 
dynamically observed or recognized. 

The figure "State Description" shows the 
format of the state description. A 
detailed specification for each of the 
fields follows the figure. 
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Explanation^ 



C Interception code 

F Interception status 

IPA Instruction parameter A 

IPB Instruction parameter B 

IPC Instruction parameter C 



M Mode controls 

MS Main storage 

r Reserved 

S State controls 

V Intervention requests 



State Description 



370-XA Interpretive Execution 



CONTROL OF OPERATIONS 



This section describes the controls for 
handling pending requests for action and 
the controls over the modes of interpre- 
tLve executioTL^ 



INTERVENTION REQUESTS (V) 



Intervention-request controls are 
provided to indicate that interception 
is requested so control can be returned 
to the host program for handling a guest 
I/O interruption* a guest external 
interruption* or an externally initiated 
request to stop. 

When set to one* an intervention-request 
bit causes an interception under the 
conditions described below. 
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P: 



I: 



Reserved 



i ntercepti on 



A stop 

requested. 

A stop interception 

requested. 



1 s 



i s 



not 



An I/O interception is 
requested. Interception occurs 
when a guest PSW I/O-mask bit is 
one. That is* in the BC mode at 
least one of the guest PSW bits 
0-6 is one* and in the EC mode 
(System/370 and 370-XA) PSW bit 
6 is one. 

An I/O interception is not 
requested. 

An external interception is 

requested. Interception occurs 

when the guest PSW external mask 

(PSW bit 7) is one. 

An external interception is not 

requested. 



An intervention-request bit is inspected 
under these circumstances: 



E: 



On entry to the 
execution mode. 



interpret! V( 



2. 



When the new PSW is loaded after 
completion of the execution of a 
guest LPSW* SSM, or STOSM instruc- 
tion* and after a guest program or 
supervisor-call interruption, 

An intervention request is recog- 
nized after the validity of a new 
PSW is established and either 
before corresponding interruptions 
enabled by the new PSW are recog- 
nized or before an instruction is 
fetched. 



Periodically when more than one CPU 
is in the configuration. Periodic 
inspection may or may not be 
provided when a configuration 
consi sts of only one CPU or when 
the host TOD clock is in the error* 
stoppedjL o r no tr o p eraii on a L siaie^ 
The period between periodic 
inspections is referred to as the 
polling interval. 
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The intervention-request bits are not 
reset to zeros by the machine on the 
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cepti on. 



STATE CONTROLS (S) 



The state-control byte provides a means 
of recording a requirement for a 
location-80 (interval-timer) external 
interruption, which nominally became due 
because the interval timer was decre- 
mented through zero. 

The byte is set on exit from the 
interpretive-execution mode to indicate 
whether there is a pending guest 
interval-timer interruption. The byte 
is examined on entrance to the 
interpretive-execution mode and also 
when the guest becomes enabled for 
interval-timer interruptions. 
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T: 



A guest external interruption 
for the interval timer is to be 
taken when the guest is enabled 
for interval-timer interruptions 
(PSW bit 7 and CRO bit 24 are 
ones). This bit is examined 
only for a guest operation in 
the System/370 mode and is 
ignored in the 370-XA mode. 

When the corresponding guest 
interruption* and associated 
mandatory interception which 
places the interruption parame- 
ters in the state description* 



r : 



occurs, the T bit is reset to 
zero. 

An interval-timer interruption 
is not requested. 

Reserved 



MODE CONTROLS (M) 



For the System/370 mode, control is 
provided over whether the interval timer 
is active. A control is provided as 
well over whether the guest is executed 
in the System/370 or the 370-XA mode. 
Also, there is a control over whether 
guest main storage is represented as a 
portion of a host address space or is 
considered to be assigned to the corre- 
sponding portion of host absolute 
storage. 
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MM: 



G: 
D: 



00 Invalid 

01 The guest machine is executed in 
the System/370 mode. 

10 The guest is executed in the 
370-XA mode. 

11 Invalid 

Pageable-storage modfc 

1 Preferred-storage mode 

Interval timer active 

1 Interval timer inactive 

D is ignored when MM is not 01. 
Reserved 



designate a location within guest main 
storage. Bits 1 through 7 may or may 
not be ignored when the System/370 mode 
is specified; if they are not ignored, a 
nonzero value causes a validity inter- 
ception. 

When both the System/370 mode and the 
pageable-storage mode are specified, 
prefixing is applied to guest dynamic- 
address-translation table references for 
both implicit translation and for LOAD 
REAL ADDRESS. When the preferred stor- 
age mode or the 370-XA mode is 
specified, prefixing may or may not be 
applied to dynamic-address-translation 
table references for implicit trans- 
lation and for LOAD REAL ADDRESS. 
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The same origin value within the same 
host address space may be designated in 
another state description for the 
purpose of interpreting a shared-main- 
storage multiprocessing configuration. 



STORAGE DEFINITION 



This section describes how the location 
of guest storage within host storage is 
specified and how the amount of guest 
storage to be made available is speci- 
fied. Provision of prefixing for the 
guest is also described. 
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This field contains the contents of 
guest prefix register. Prefixing 
considered to be installed for 
guests. A validity interception 
recognized if the prefix value does 
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MAIN-STORAGE EXTENT 
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This field specifies the max 
of contiguous bytes of main s 
are made available to the gue 
the pageable-storage and 
storage modes. The extent is 
of 64K bytes, expressed as on 
the multiple to be allowed; 
value of n causes (n + 1) 
bytes to be made available 
the guest. 
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A validity interception is presented 
when the preferred-storage mode is spec- 
ified if either the state description or 
the host prefix would fall within the 
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storage available to the guest* that is* 
if the extent value is not less than the 
contents of bits positions 1-15 of the 
address of the state description and if 
it is not less than bits 1-15 of the 
host prefix value. 

If the sum of the main-storage origin 
and the extent of guest main storage* 
without wrapping* exceeds the length 
specified for the segment table desig- 
nated by host control register 1 when 
the pageable-storage mode is specified* 
a validity interception may or may not 
be presented. 

In the preferred-storage mode* the stor- 
age allowed by the extent value may 
include locations which are not avail- 
able in the real configuration. No 
check for this is performed on entry to 
the interpretive-execution mode. 



GENERAL REGISTERS AND THE PSW 



The contents of just two of the guest's 
general registers are obtained from the 
state description. Described below are 
the fields that contain the contents for 
these registers and the requirement to 
preserve the host contents for these 
registers. Also described is the field 
containing the guest PSW that is stored 
on exit from the interpretive-execution 
mode and that is used on entry to the 
interpretive-execution mode. 
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state description is the PSW which would 
have been stored as the guest- 
interruption old PSW. 



TIMING CONTROL 



This section describes the two fields 
that contain the contents of the guest's 
CPU-timer and clock-comparator regi- 
sters. Also described are the residue 
field* used in maintaining the guest 
interval timer* and the epoch field, 
used in providing a guest TOD-clock 
value. 
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Between the instant that some condition 
causing exit from the interpretive- 
execution mode is initially recognized 
and exit from the interpretive-execution 
mode finally occurs* additional time may 
be reflected in the values placed in the 
state description for the guest CPU 
timer and interval timer. The condition 
of these values* and the enabled state 
of the guest, may indicate that an 
interruption is due. Interruptions and 
interceptions which become due during 
exit from the interpretive-execution 
mode are not necessarily recognized 
instead of the condition which initiated 
the exit* even if the new condition is 
ordinarily handled at a higher priority. 

If a CPU is in the interpretive- 
execution mode when the host TOD clock 
accessed by that CPU enters the running 
state or i s changed by another CPU shai — 
i ng the same host TOD clock, the values 
of the guest interval timer, residue 
field, and guest CPU timer may be unpre- 
dictably changed. Also, guest 
interruptions due to the interval timer, 
CPU timer* and clock comparator may be 
lost* delayed* or erroneously generated. 



This field contains the contents of the 
guest PSW. The PSW specifies control 
and status information under which 
instruction execution for the interpret- 
ed machine starts on entry to the 
interpretive-execution mode. On exit 
from the interpretive-execution mode, 
the contents of the current guest PSW 
are stored in this field. When the exit 
from the interpretive-execution mode is 
due to interception for a guest inter- 
ruption, the guest PSW stored in the 



RESIDUE COUNTER 



Resi due 





20 



31 



The residue-counter field is used to 
maintain an accurate accumulation of CPU 
time spent in the interpretive-execution 
mode that has not yet been accounted for 



by decrementing the interval timer in 

guest storage. This field is ignored 

when the interval timer is not 
acti vated. 

Bits 0-19 of the residue-counter field 
are considered to constitute an unsigned 
integer* with bit 19 representing micro- 
seconds. The use of bits 20-31 depends 
on the model; normally they should be 
set initially to zeros. The format of 
the residue field thus corresponds to 
bits 32-63 of the TOD clock. 

On entry to the interpretive-execution 
mode, the interval timer in guest stoi — 
age is adjusted by decrementing bit 
position 23 once for each integral 
multiple of 3,333 microseconds contained 
in the residue counter. The correspond- 
ing amount is deducted from the counter, 
with the remainder treated as an initial 
elapsed-time value. The adjustment may 
or may not occur when a preexisting 
interception-causing condition is recog- 
nized on entry to the interpretive- 
execution mode. 

On exit from the interpretive-execution 
mode, the residue counter field contains 
the sum of the value of the residue 
counter at entry, plus the CPU time 
considered to have elapsed in the 
interpretive-execution mode since entry, 
minus 3,333 microseconds for each time 
the interval timer has been decremented 
in guest storage. 



Epoch Difference 
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63 
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INTERCEPTION CONTROL 



The term "conditional interception" 
refers to functions which are executed 
for the guest unless a specified condi- 
tion is encountered which causes control 
to be returned to the host by the proc- 
ess called interception. Described 
below are some of the controls which can 
cause interception when the related 
function is handled for the guest. 



SVC CONTROLS 



CPU TIMER 



CPU Timer 
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This field is provided for the guest 
CPU-timer value. The guest CPU timer is 
incremented only when the machine is in 
the interpretive-execution mode and at 
the same rate as the host CPU timer. 



CLOCK COMPARATOR 



This field provides for optionally 
intercepting either every guest SUPERVI- 
SOR CALL (SVC) or just those for which 
the SVC code matches one of up to three 
given values. 



AFSTrrrr 


F code 


S code 


T code 



8 



16 



24 



31 



Instruction interception occurs 
for every guest SVC instruction. 
Interception occurs only for 
guest SVC instructions for which 
the SVC code is equal to a 
control code enabled for match- 
ing by one or more of the next 
three bits. 



Clock Comparator 
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63 



This field contains the guest clock- 
comparator value. 



Instruction interception occurs 
for a guest SVC instruction for 
which the SVC code is equal to 
the contents of the F-code byte. 
A match with F code is not 
recogni zed. 

Same as for F but applies to S 
code. 



EPOCH DIFFERENCE 



T: Same as for F but applies to T 
code. 



F code: A one-byte value to be compared 
with the contents of the I field 
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of SVC instructions if matching 
is allowed by a one in bit posi- 
tion F. 

S code: Same as for F code but with 
respect to the S bit. 

T code: Same as for F code but with 
respect to the T bit. 



25 SET CPU TIMER and STORE CPU 
TIMER 

26 SET CLOCK COMPARATOR and STORE 
CLOCK COMPARATOR 

Unassigned bits are reserved. 



INTERCEPTION PARAMETERS 



LCTL CONTROLS 



The bits of this field are numbered, 
starting from the left, to correspond to 
control-register numbers. When a bit is 
one and a guest LOAD CONTROL (LCTL) 
designates the corresponding control 
register in the range of registers to be 
loaded, instruction execution is 
suppressed, and instruction interception 
is recognized. 



INTERCEPTION CONTROLS (IC) 



A bit value of one causes interception 
when the associated function is encount- 
ered in the guest. 



Bit 
Posi ti on 


1 



4 
5 
6 

7 
9 

10 
11 
13 
14 
15 
16 
17 

18 

19 

20 
21 
22 
23 



Associ ated Functi on 

Invalid operation 
Program interruption (privi- 
leged-operation exception) 
Program interruption (other 
than mandatory, bit~0, and 
bit-1 cases) 
TEST AND SET, for CC1 
COMPARE AND SWAP, for CC1 
COMPARE DOUBLE AND SWAP, for 
CC1 

INVALIDATE PAGE TABLE ENTRY 
LOAD PSW 
PURGE TLB 
SET SYSTEM MASK 
STORE CONTROL 

STORE THEN AND SYSTEM MASK 
STORE THEN OR SYSTEM MASK 
STORE CLOCK 

INSERT STORAGE KEY and INSERT 
STORAGE KEY EXTENDED 
SET STORAGE KEY and SET STOR- 
AGE KEY EXTENDED 
RESET REFERENCE BIT and RESET 
REFERENCE BIT EXTENDED 
PROGRAM CALL 
PROGRAM TRANSFER 
TEST PROTECTION 
LOAD ADDRESS SPACE PARAMETERS 



Exit from the interpr 
mode takes two forms, 
interruption, after which 
condition can be handl 
program. The second is 
ception and causes 
instructions to resume in 
the instruction follow 
instruction. Normally, 
results from a function 
encountered i n the guest 
treated by a host program 
condition to be efficien 
the host program, vario 
information about the 
stored in the state desc 
i rGm trie interpretive - 
(that is, at interceptio 
mat ion provided is desc 
secti on. 



INTERCEPTION CODE (C) 



eti ve-execut i on 

One is exit by 

the causative 

ed by a host 

exit by i ntei — 

execution of 

the host with 

i ng the SIE 

i ntercepti on 

or condition 

which is to be 

To allow the 

tly analyzed by 

us descriptive 

condition is 

ription on exit 

CACWU V. I Ull IllUUtg 

n). The infoi — 
ribed in this 



The code placed in this field during 
interception indicates the reason for 
the interception. The contents of this 
field are changed only at interception. 



Intrcptn 
Code 



i nter- 



Interception Condition 

Code Appli cable to the Guest 

04 Instruction 

08 Program interruption 

12 Instruction and program 

rupti on 

16 External request 

20 External interruption 

24 I/O request 

28 Wait state 

32 Validity 

40 Stop request 

44 Operation exception 

Unassigned codes are reserved. 

The definitions of the conditions under 
which each code is used are given below. 
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Code 04 (Instruction) 



Instruction interception is indicated 
both for instructions for which inter- 
ception is mandatory and for 
instructions for which the option to 
intercept is chosen. The conditions 
under which instruction interception are 
recognized apply to the target instruc- 
tion of EXECUTE. 

Some instructions are valid either in 
the 370-XA mode or in the System/370 
mode, but not in both modes. When 
instruction interception is either 
mandatory or conditional in the mode for 
which the instruction is valid, depend- 
ing on the model, instruction 
interception may be recognized uncondi- 
tionally in the invalid mode rather than 
an operation exception. 

Guest instruction execution is 
suppressed when code 04 is given. 



Code 08 (Program Interruption) 



Code 12 (Instruction and Program 
Interrupt i on) 



This code is indicated only for 
instructions that cause an interception 
after completing execution and for which 
a PER event has also occurred. The PER 
event results in the placement of the 
correspondi ng program-i nterrupt i on 
parameters in the state description. 
Code 12 is indicated regardless of 
whether the interception control for the 
program interruption is also set to 
cause interception. These conditions 
apply to the instructions COMPARE AND 
SWAP, COMPARE DOUBLE AND SWAP, and TEST 
AND SET, for which conditional inter- 
ception is recognized when condition 
code 1 is set. 



Code 16 (External Request) 



Interception is due to bit 7 of the 
intervention-request field being one 
when PSW bit 7 is one. 



Interception is mandatory, and the 
interception code is set to 08, for 
guest program interruptions caused by 
these exceptions: 

Protecti on 

Addressi ng 

Speci f i cat i on 

Special operation 
Otherwise, program interruptions cause 
an interception only if they are of a 
type for which the corresponding intei — 
ception control, bit 1 or bit 2, is set 
to one. 



A protection exception may 
key mismatch, guest page 
protection, guest 
protection, or host page 
(These conditions are also 
the condition code for a 
PROTECTION instruction.) 



be due to a 
or segment 
low-address 
protecti on. 

used to set 
guest TEST 



An addressing exception may be due to a 
host segment-table entry or page-table 
entry at an invalid address, or an 
invalid guest or host absolute address. 

In all cases of interception, the param- 
eters of the interruption are placed in 
the state description at interception. 
The PSW placed in the state description 
is the current guest PSW or, in the case 
of a guest program interruption, the 
guest old PSW. 



Code 20 (External Interruption) 



Interception is mandatory for guest 
external interruptions. Guest external 
interruptions are generated for the 
following facilities: 

Guest clock comparator 
Guest CPU timer 
Guest interval timer 

The parameters of the interruption are 
placed in the state description. 



Code 24 (I/O Request) 



Interception is due to bit 6 of the 
intervention-request field being one 
either when any of bits 0-6 of a BC-mode 
PSW is one or when bit 6 of an EC-mode 
PSW is one. 



Code 28 (Wait State) 



Interception is due to bit 14 of the 
guest PSW being one when no other intei — 
vention, interruption, or interception 
condition meets the conditions for 
recogni ti on. 
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Code 32 (Validity) 



Interception for validity is or may be 
indicated for the following conditions: 

1 . A mode is spfic i f i ed t ha t is in va 1 id 
or not installed on the model. A 
validity interception may also be 
presented when a model-dependent 
limit is exceeded. 

2. For the pageable-storage mode, part 
of guest main storage maps to a 
host address-space location that 
appears to exceed 2 31 -1 (that is, 
guest main storage appears to wrap 
in the host address space). 

Optionally, a validity interception 
may also be recognized on entry to 
the interpretive-execution mode 
when guest main storage exceeds the 
length of the host virtual address 
space, as specified in the 
segment-table length in control 
register 1, or an invalid format is 
specified in host control register 
0. Alternatively, these conditions 
may be recognized instead as host 
translation exceptions when a 
translation is performed. 

3. For the pageable-storage mode, the 
origin of the RCP area is 0, or 
wrapping of the RCP area is implied 
by the amount of guest main storage 
specified, or the implied size of 
the RCP area exceeds the host 
address-space length as specified 
in the segment-table length in 
control register 1. 

4. For the preferred-storage mode, 
guest main storage includes the 
state description or host real page 
0, or the main-storage origin is 
not zero. 

5. Guest real page 0, designated by 
the prefix value in the state 
description, is not within guest 
main storage. For the System/370 
mode, bits 1-7 of the prefix value 
may or may not be examined. When 
they are examined, nonzero contents 
result in a validity interception. 

S. An access exception is encountered 
when referencing guest real page 
to perform a program or 
supervisoi — call interruption, or to 
update the interval timer. In the 
pageable-storage mode, host trans- 
lation exceptions are allowed, 
alternatively, to be recognized as 
such instead, rather than resulting 
in a validity interception, in 
which case the guest operation is 
nullified. The existence of an 
access exception may or may not be 
recognized on entry to the 
interpretive-execution mode and 
result in a validity interception. 



7. Either during execution of INVALI- 
DATE PAGE TABLE ENTRY or on entry 
to the interpretive-execution mode, 
bits 1-19 of the SCA match the host 
prefix value or are zero when bits 
20-27 are not zero, indicate an 
invalid address, or, in the 
preferred-storage mode, designate 
storage within the guest extent. 

State-description information for which 
validity checking is defined is checked 
each time it is fetched from the state 
description. This may occur at times 
other than on entry to the 
interpretive-execution mode. 

A validity interception which is caused 
by an inability to access guest real 
page may result in the loss of infor- 
mation for these items: 

• Interruption or interval-timer 
information to be placed in guest 
real page 

• The T bit in the state-control byte 

• The residue field 

• The guest PSW placed in the state 
descripti on 

Before any reference i s made to guest 
main storage on entry to the 
interpretive-execution mode, a validity 
check is made of the mode control and, 
in preferred-storage mode, for inclusion 
of the state description and host real 
page within guest main storage. 
Interception for invalid mode controls 
takes precedence over all other reasons 
for interception. 



Code 40 (Stop Request) 



Interception is due to bit 5 of the 
intervention-request field being one. 



Code 44 (Operation Exception) 



An operation code which is unassigned in 
both the 370-XA and System/370 modes is 
handled as follows: 

1. A guest program interruption for an 
operation exception is taken unless 
interception-control bit is one. 

2. An interception is recognized when 
interception-control bit is one 
and the following conditions occur: 

a. Interception code 44, operation 
exception, is given. 
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b. The first two bytes of the 
instruction are placed in 
instruction parameter A (IPA). 
Instruction parameter B (IPB) 
and instruction parameter C 
(IPC) are set to zero. 
Instruction execution is 
suppressed. The instruction- 
length code (ILC) in a guest 
BC-mode PSW is not necessarily 
valid. Interruption parameters 
are not generated, axcept that 
the interruption-code portion 
of a BC-mode PSW may or may not 
specify operation exception. 

c. The EX bit (bit 7) of inter- 
ception status is set to speci- 
fy whether the unassigned 
operation code is the target of 
sn EXECUTE instruction. 

d. The IF bit (bit 6) of inter- 
ception status is set to speci- 
fy whether an I-fetch PER event 
i s applicable. 
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INTERCEPTION STATUS (F) 



This field specifies, for interception 
for a guest instruction, whether an 
I-fetch PER event is applicable and 
whether the guest instruction causing 
the interception is the target of a 
guest EXECUTE instruction. Zero is 
stored in this field for interception 
codes other than 04, 12, and 44. 



When the bit is zero, an 
instruction-fetch PER event has 
not been recognized. The bit is 
always set to the appropriate 
value for interception codes 04 
and 44 J the bit may or may not be 
set for interception code 12. 

EX: 1 Interception applies to an 
instruction that is the target of 
an EXECUTE instruction. The 
condition is indicated with 
interception codes 04, 12, and 
44. 

The instruction for which inter- 
ception is indicated is not the 
target of an EXECUTE instruction. 



LAST-HOST-CPU ADDRESS 



Last-Host-CPU Addr 



On 

the 

the 

with 

field 



IE 
000000FX 
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On models which retain guest TLB entries 
after exit from the interpretive- 
execution mode, this field contains the 
16-bit host CPU address of the CPU that 
was most recently in the interpretive- 
execution mode for this state 
description, as would be obtained by a 
host STORE CPU ADDRESS instruction, 
these models, on entry to 
interpretive-execution mode, 
contents of this field are compared 
the host CPU address. If the 
matches, then existing guest-type TLB 
entries can be used. If the field does 
not match, then existing guest-type TLB 
entries for this guest are purged. On 
models which purge guest TLB entries on 
exit from the interpretive-execution 
mode, the contents of this field are 
unpredi ctable. 

The value FFFF hex can be used by the 
program to cause copies of information 
retained internally to be discarded. 

This field may be updated by the machine 
on entry to the interpretive-execution 
mode. 



IF: 1 When the bit is one, an 
instruction-fetch PER event is 
applicable to the instruction for 
which interception has occurred. 
When the intercepted instruction 
is the target of an EXECUTE 
instruction, the instruction- 
fetch event is indicated when it 
is applicable to either the 
EXECUTE instruction or the target 
instruction or both. This condi- 
tion is indicated only with 
interception codes 04 and 44. 



INSTRUCTION PARAMETER A (IPA) 



Instruction 
Bits 0-15 



15 

When the code is 04, 12, or 44, this 
field contains the first two bytes, bits 
0-15, of the instruction causing the 
interception, as modified by EXECUTE if 
applicable. Zero is stored in this field 
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for interception codes 
12, and 44. 



other than 04, 



INSTRUCTION PARAMETER B (IPB) 



Addressing information is placed in this 
field in conjunction with intercepting 
for some instructions. Zero is stored 
for all interception codes other than 
04, and when the instruction for which 
the interception is indicated is not 
defined to provide an addressing parame- 
ter. The formats that are used are 
shown below. 

In the first case, an address is formed 
according to the current guest address- 
ing mode, as the sum D(B), and then is 
placed in this field as a 31-bit value. 
This format is used for instruction 
interception for RX, RS, SI, and S 
format instructions, and for the first 
operand address for SSE format 
instructions. 



Operand Address 



31 

In the second case, the fourth byte of 
an RRE-format instruction, which speci- 
fies Ri and R a , is placed in the fourth 
byte of this field. The contents of bit 
positions 0-23 may or may not change. 



Ri R2 



24 



31 



ORIGINS OF RELATED TABLES 



Depending on the controls specified, 
additional tables are used to contain 
control information. The origins of 
these tables are obt a ined from the st ate 
description, from the fields described 
below. 



RCP-AREA ORIGIN 



/ 


RCP-Area Origin 


//////////// 



1 



20 



31 



The contents of this field, with 12 zero 
bits appended at the right, specify the 
host virtual address of an area used to 
retain change and reference information. 
This address i s on a 4K-byte page bound- 
ary within the address space specified 
by host control register 1. This field 
is ignored when the preferred-storage 



mode 



speci 



■ he 



con v.ci • n ' 



one byte for each 4K bytes of guest main 
storage, with the index of a byte within 
the area equal to the index of the 
corresponding 4K-byte block within guest 
main storage. A validity interception 
is recognized if the origin field speci- 
fies zero, or if an addressing overflow 
(wraparound) would be encountered for 
any byte of the area. A validity inter- 
ception may or may not be recognized if 
the area would exceed the length of the 
host address space. 



SYSTEM-CONTROL-AREA ORIGIN 



INSTRUCTION PARAMETER C (IPC) 



FT 



Operand Address 
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Addressing information is placed in this 
field in conjunction with interception 
for an SSE-format instruction. Zero is 
stored in this field for all intei — 
ception codes other than 04, and when 
the instruction for which the inter- 
ception is indicated is not defined to 
provide this addressing parameter. The 
guest second-operand address is formed 
according to the current guest address- 
ing mode, as the sum D(B), and then is 
placed in this field as a 31-bit value. 



SCA Origin 



//// 



1 28 31 

The origin of the SCA is contained in 
bits 1-27. With four zeros appended on 
the right, the origin is treated as a 
real address. Bit and bits 28-31 are 
ignored. 

A validity interception is recognized, 
either during execution of INVALIDATE 
PAGE TABLE ENTRY (IPTE) or on entry to 
the interpretive-execution mode, if bits 
1-19 match the host prefix value or are 
zero when bits 20-27 are not zero, if 
they contain an invalid address, or, in 
the preferred-storage mode, if they 
designate storage within the guest 
extent. 

IPTE is executed without broadcasting 
when bits 1-27 are zeros. When bits 
1-27 are not zeros, broadcasting for 
guest IPTE instructions is performed, 
removing all guest TLB entries formed 
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under a matching SCA-origin value on all 
CPUs in the configuration. 

Bit of the SCA, the IPTE-i nterlock- 



one at the 
and to zero 
by means of 
the initial 
instruction 
instructi on 



control (K) bit* is set to 
beginning of IPTE execution, 
on completion of execution, 
an interlocked update. When 
value of the bit is one, 
execution is suppressed, and 
interception is recognized. 



OTHER CONTROLS 



This section describes a control field 
related to I/O operations for the guest. 



with the assurance that the change will 
be observed by a CPU in the 
interpretive-execution mode for the 
state description containing the changed 
bytes. 



CONTROL REGISTERS 



CRO 



CR15 



This area contains the 16 control regis- 
ters for the guest on entry to and on 
exit from the interpretive-execution 
mode. The registers appear in ascending 
order of register numbers, starting with 
control register 0. 



TCH CONTROL 



TCH Control 
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This field may be changed dynamically by 
an interlocked update by another CPU 



INTERRUPTION PARAMETERS 



For all guest external interruptions, 
and for guest program interruptions 
associated with an interception for 
which the general definition specifies 
storing at locations 128 through 159, 
storing in the interpretive-execution 
mode occurs instead in the state 
description at locations 192 through 
223. Locations 192 through 223 of the 
state description are formatted identi- 
cal to locations 128 through 159 of the 
guest. Storing is appropriate to the 
mode of the guest PSW, which is either 
the 370-XA mode, System/370 BC mode, or 
System/370 EC mode. Storing occurs in 
conjunction with interception codes 08, 
12, and 20. 
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CHAPTER £,. STORAGE 



ADDRESSING 



Two mechanisms are provided for repres- 
enting guest main storage. One mech- 
anism represents guest main storage as a 
contiguous portion of the host virtual 
address space designated by host control 
register 1. The origin of guest main 
storage within the host address space is 
provided in the state description. This 
is called the pageable-storage mode. 

The second mechanism represents guest 
absolute addresses as corresponding to 
host absolute addresses; host dynamic 
address translation (DAT) and host 
prefixing are not applied. This is 
called the preferred-storage mode. 

In both cases, the amount of guest main 
storage to be provided is specified in 
the state description. 

The guest may also use DAT. A guest 
virtual address is first translated to a 
guest real address, using guest trans- 
lation tables. Guest prefixing is then 
applied to produce a guest absolute- 
main-storage address. A guest 
absolute-main-storage address is treated 
as the corresponding host absolute- 
main-storage address when the 
preferred-storage mode is specified. 
When the pageable-storage mode is speci- 
fied, a . rAo guest_ absolute address is 
converted "to* a host virtual address by 
adding to it the host virtual address at 
which guest storage begins in the host 
address space (from the main-storage- 
origin field in the state description). 
The host address i s then translated by 
using host translation tables designated 
by host control register 1. Finally, 
host prefixing is applied. Host-DAT 
translation exceptions for host 
addresses result in host interruptions, 
while guest-DAT translation exceptions 
for guest addresses result in guest 
interruptions. All addressing and 
protection exceptions are considered 
guest exceptions. The address- 
translation mechanisms are illustrated 
in the figure "Translating Addresses for 
Interpretive Execution." 

Guest DAT table entries are designated 
by guest real addresses. In the 
pageable-storage mode, these table-entry 



addr esses are converted to h ost virtual 
addresses, which are "~theh~"'t"ranslated~Tb" 
host real addresses. When the 
System/370 mode is specified, prefixing 
is applied to DAT table-entry addresses 
in the pageable-storage mode, but may or 
may not be applied in the preferred- 
storage mode for references for implicit 
address translation and by the LOAD REAL 
ADDRESS instruction. In the 370-XA 
mode, prefixing may or may not be 
applied to DAT table-entry addresses in 
both the pageable-storage mode and 
preferred-storage mode. In all cases, 
however, prefixing applies to the oper- 
and address of the INVALIDATE PAGE TABLE 
ENTRY instruction in the same way as 
when the machine ijs in interpretive- 
execution mode. 

Depending on the model, the support of 
DAT in the System/370 mode may or may 
not include support for the lM-byte- 
segment size and for the 2K-byte page 
size. All models support the 64K-byte 
segment size and 4K-byte page size. 
When the page size is 4K bytes, the 
effective page-frame real address is 
always formed by appending page-table- 
entry bits 13-14, giving a 14-bit value 
which allows 26-bit real-storage 
addressing for a guest in the System/370 
mode. 

Guest-type TLB entries may be formed to 
provide a rapid means of translating 
guest storage addresses to host real 
storage addresses. These entries may or 
may not be retained when the CPU exits 
from the interpretive-execution mode. 
The entries thus formed are associated 
with both guest and host translation 
parameters, and with the host real 
address of the state description, the 
host real address of the system-control 
area, and the host CPU address on which 
last executed. Dispatch- 
on a different host CPU 
TLB entries to be purged 
that were previously 
a matching state- 



the guest was 
i ng a guest 
causes guest 
automatically 
formed under 



description address. A host PURGE TLB 
(or INVALIDATE PAGE TABLE ENTRY) must be 
issued when the host program changes any 
of the host or guest translation parame- 
ters, reassigns storage assigned to a 
state description or a system-control 
area, or changes between the preferred- 
storage and the pageable-storage modes. 
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Translate on 
Method 



Address Type 



Notes 



Use guest 
translati on 
tables 



Use guest 
prefix 



Guest virtual 



Guest real 



Add 

host origin 



Use host 

translation 

tables 



Use host 
prefix 



— Guest absolute 



Host virtual 



Translation exceptions using 
the guest tables are pre- 
sented to the guest. 

The page-protection bit is 
retained. 



Prefixing is applied. 

The guest absolute address 
must not exceed the storage 
allotted for interpretive 
execution. 



The host virtual address 
must fall within the host 
address space defined by 
host control register 1, 
without wrapping. 



Translation exceptions are 
presented to the host. 



Host real 



►Host absolute 



The page-protection bit 
retained. 



i s 



* In the preferred-storage mode, a guest absolute 
address is treated unmodified as a host absolute 
address. 



Translating Addresses for Interpretive Execution 



ACCESS CONTROLS 



Guest accesses to guest storage, in all 
modes of interpretive execution, are 
subject to key-controlled protection in 
the usual way, by using the real storage 
keys. Guest accesses are also subject 
to guest low-address protection, to 
guest segment protection when the 
System/370 mode is specified, and to 
guest page protection and guest fetch- 
protection override when the 370-XA mode 
is specified. 

In addition, host page protection 
applies to guest references in the 
pageable-storage mode. This checking 
applies to guests in both the System/370 
and 370-XA modes and includes the check- 
ing of guest references to guest main 
storage and the checking of implied 
references to the RCP area. Disallowed 



storing causes a guest program inter- 
ruption for a protection exception. 
However, disallowed storing into guest 
real locations 0-4095 to perform a guest 
program or supervisor-call interruption, 
unless the operation is nullified, or to 
update the interval timer, results in a 
validity interception. 

INSERT STORAGE KEY, INSERT STORAGE KEY 
EXTENDED, SET STORAGE KEY, and SET STOR- 
AGE KEY EXTENDED are interpreted by 
fetching and storing, respectively, the 
access-control and fetch-protection bits 
in the real storage key. In the 
pageable-storage mode, additional infor- 
mation concerning the change and 
reference bits is kept in a byte in a 
table called the RCP area. 

Obtaining the host main-storage address 
associated with the guest real storage 
address specified by the key-handling 
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370-XA Interpretive Execution 



instructions — and thereby specifying 
the real storage key to be 
used — requires translating a host 
address in the pageable-storage mode. 
The access to the RCP area also involves 
translating a host address. It is 
unpredictable whether access exceptions 
for the T£CP area ore recogni zed before 
access exceptions for the real key are 
recogni zed. 

In the interpretive-execution mode? no 
checking occurs with respect to the host 
PSW key. No storage-key protection is 
applicable to references to the state 
description or to references to the RCP 
area. 



CHANGE-AND-REFERENCE HANDLING 



When the pageable-storage interpretive- 
execution mode is specified* a page 
frame of host real storage may be the 
object of a translation for guest 
purposes and for host purposes simulta- 
neously * The setting or resetting of 
the real reference and change bits 
through the use by the guest of RESET 
REFERENCE BIT, RESET REFERENCE BIT 
EXTENDED, SET STORAGE KEY, AND SET STOR- 
AGE KEY EXTENDED in conjunction with 
managing guest storage would leave the 
bits in an incorrect state for managing 
host real storage. Conversely, changes 
to these bits by host actions result in 
the real indicators not correctly indi- 
cating the status of guest real storage. 
For this reason, three sets of bits are 
maintained. One set is the real-storage 
set. The bits in this set are the only 
indicators affected by storage accesses, 
including accesses by subchannels. The 
other two sets are maintained in 
RCP-area table. One set, the host 
set, is used to retain status for 
host when the real set is changed 
guest key-handling operations, 
other set, the guest RCP set, 
provided to retain status for the guest 



when the real set is changed by host 
operations. True status is obtained by 
ORing real status with the appropriate 
set in the RCP area. 



me rvvi dies 

each 4K bytes 
wrwa ts desi 
state descri 
host address 



consists of one byte for 
of guest storage. The RCP 
by an address in the 
ion and resides in the 
space designated by host 
control register 1. An RCP area is 
provided only when the pageable-storage 
mode is specified. The same area can be 
designated in more than one state 
description when a guest shared-main- 
storage multiprocessing configuration is 
interpreted. The byte associated with a 
particular 4K-byte block is identified 
by an index which equals the offset of 
the corresponding 4K-byte block in guest 
main storage, beginning with guest abso- 
lute zero. Only as many bytes are 
provided as there are guest 4K~byte 
main-storage blocks. 

Five bits of each byte in the RCP area 
are used. The first bit is an interlock 
control which is set by each key- 
handling instruction in the pageable- 
storage mode to provide exclusive use of 
the byte. The next two bits are used to 
save the host reference and the host 
change indications, respectively. Simi- 
larly, the next two bits are provided 
for saving the guest reference and 
change indications. The format of a 
byte of the RCP area is illustrated 
below: 



H H 
IRC 


/ / 


G G 
R C 


/ 



the 


I 


RCP 


HR 


the 


HC 


by 


GR 


The 


GC 


1 s 


/ 



RCP interlock control 

RCP host reference indicator 

RCP host change indicator 

RCP guest reference indicator 

RCP guest change indicator 

Bits 3, 4, and 7 are ignored 

unchanged 



and 
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CHAPTER 1^. FACILITY HANDLING 



The following facilities* in addition to 
the ba sTcT compu Ft Tf ng Tu n c t i o n s deTi ned^ i~n 
the IBM Sv5tem/37 Principles of Opera- 
tion , constitute the System/370 facili- 
ties provided as standard under 
interpretive execution: 

• Universal instruction set (includes 
standard instruction set, floating 
point, and decimal) 

• Extended-precision floating point 



Translation (with 
optional and 
opti onal) 



lM-byte segments 
2K-byte pages 



• Extended (26-bit) real addressing 

• CPU timer and clock-comparator 
faci li ty 

• Conditional swapping 

• PSW-key handling 

• Multiprocessing 

• Storage-key 4K-byte block 

• Extended facility: IPTE, low- 
address protection, and TEST 
PROTECTION 

TEST BLOCK 

• Branch and save 

• Dual address space 

• Storage-key-instruction extensions 

• Segment protection 

Instructions defined for the 370-XA mode 
and not defined for the System/370 mode 
cause an operation exception to be 
recognized when the System/370 mode is 
specified for the guest. 

The basic 370-XA architecture is 
provided as standard when the 370-XA 
mode is specified for the guest. 

All control registers are considered to 
be installed in the guest machine. 

Optional facilities may or may not also 
be offered in the interpretive-execution 
mode. Depending on the facility, full 
interpretive execution may be provided, 
or only portions may be provided, with 
the rest to be provided by programmed 
means. Several facilities are more 
fully described in the following 
sections. 



GUEST INSTRUCTION PROCESSING 



Most guest instructions are fully inter- 
preted, with execution proceeding from 
one guest instruction to the next in a 
normal fashion. However, some guest 
instructions require treatment by the 
host program. Control is returned to 
the host program in these cases by a 
process called interception. Inter- 
ception occurs for some instructions 
after they have been completed. 
However, most instructions for which 
interception occurs are suppressed prior 
to interception. The two general 
reasons for interception are 

(1) interception has been selected by a 
bit set to one in the state description 
associated with the instruction, or 

(2) the instruction is not interpreted 
under the existing conditions, in which 
case interception is mandatory. Useful 
parameters of the guest instruction are 
usually provided at interception. 

The privileged-operation, specification, 
and special-operation exceptions can be 
recognized ahead of instruction inter- 
ception. For the conditionally inter- 
ceptible instructions, all other 
applicable exceptions can also be recog- 
nized ahead of interception. 

Following is a list of instructions for 
which interception is mandatory in the 
modes in which they are valid: 

CLEAR CHANNEL 

CLEAR I/O 

CONNECT CHANNEL SET 

CLEAR SUBCHANNEL 

DIAGNOSE 

DISCONNECT CHANNEL SET 

HALT DEVICE 

HALT I/O 

HALT SUBCHANNEL 

MODIFY SUBCHANNEL 

RESET CHANNEL PATH 

RESUME I/O 

RESUME SUBCHANNEL 

SET ADDRESS LIMIT 

SET CHANNEL MONITOR 

SET CLOCK 

START INTERPRETIVE EXECUTION 

SIGNAL PROCESSOR 

START I/O 

START I/O FAST RELEASE 

SET PREFIX 

START SUBCHANNEL 

STORE CPU ADDRESS 

STORE CHANNEL PATH STATUS 

STORE CHANNEL REPORT WORD 

STORE CHANNEL ID 

STORE CPU ID 
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STORE PREFIX 

STORE SUBCHANNEL 

TEST BLOCK 

TEST I/O 

TEST PENDING INTERRUPTION 

TEST SUBCHANNEL 



INTERACTIONS OF FACILITIES 



Exit from the interpretive-execution 
mode is part of the unit of operation in 
which an interception or interruption 
condition is detected. 

The machine exits from the 
interpretive-execution mode before 
entering the stopped state, with the 
host PSW address designating the SIE 
instruction. Thus, when the machine is 
in the interpretive-execution mode, the 
host stop function is handled like a 
host interruption, except that there is 
no exchange of host PSUs. Similarly, 
the machine exits from the 
interpretive-execution mode before 
completing a reset operation. If a CPU 
reset is initiated while the machine is 
in the interpretive-execution mode, the 
contents of the state description and 
the host registers, including the host 
PSW and other host registers (such as 
the prefix register, CPU timer, and 
clock comparator) are unpredictable. If 
the host rate control is in the 
instruction-step position when the host 
PSW address designates SIE, entry is 
made to the interpretive-execution mode 
to execute a guest unit of operation, a 
guest interruption, or an interception, 
or to update the guest interval timer. 
Then the machine exits from the 
interpretive-execution mode. On entry 
to the interpretive-execution mode, a 
guest interruption has higher priority 
than the execution of a guest unit of 
operation. The definition of a unit of 
operation applicable to the guest is 
honored in the interpretive-execution 
mode. Host asynchronous interruptions 
are recognized between guest units of 
operation. Machine-check interruptions 
are presented to the host after exit 



from the interpretive-execution 
accompli shed. 



mode i s 



The START INTERPRETIVE EXECUTION (SIE) 
instruction is nullified if a machine 
check is reported while the checkpoint- 
synchronization action which is part of 
the entry to the interpretive-execution 
mode is being performed. If a machine 
check occurs during execution of a guest 
checkpoint-synchronization action in the 
interpretive-execution mode, the guest 
state and the values placed in the state 
description are unpredictable. The 
checkpoint-synchronization action on 
exit from the interpretive-execution 
mode is taken after the SIE instruction 
execution is completed. 

Interruptions and interceptions which 
become due during exit from the 
interpretive-execution mode are not 
necessarily recognized instead of the 
condition which initiated the exit from 
the interpretive-execution mode. 

A host I-fetch PER event which applies 
in the interpretive-execution mode is 
handled as for interruptible 
instructions. That is, a host program 
interruption for PER is taken (1) after 
SIE is completed because of 
interception, or (2) PER is indicated 
concurrently with another program inter- 
ruption, or (3) exit from the 
interpretive-execution mode is accom- 
plished by nullifying SIE — as if a 
host I/O, external, or machine-check 
interruption were being taken — except 
that a program interruption for PER is 
taken instead. 



SYSTEM/370 EXTENDER FA QUJTY 



The System/370 extended facility is 
provided when the System/370 mode is 
specified for the guest, subject to the 
adjustments in the methods of operation 
described below. The handling of the 
capabilities provided by the facility is 
summarized in the figure "Handling of 
System/370 Extended Facility." 
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Handling 


Capabi li ty 


F 
F 
FCIC) 

FCIC) 
F(SP) 

F(M) 
F(SP) 
F(SP) 
F 


Common-segment bit 
Low-address protection 
INVALIDATE PAGE TABLE ENTRY 

i nstructi on 
TEST PROTECTION instructTon 
Four lock-handling i nstruc- 
ti ons 
Six tracing instructions 
FIX PAGE instruction 
SVC ASSIST instruction 
Virtual-machine extended- 
facility assist* 


Explanation 2 


F Fully provided in the inter- 
pretive-execution mode. 

FCIC) Execution is provided in the 
interpretive-execution mode, 
with an option to intercept 
i nstead. 

FCSP) Execution in the interpretive- 
execution mode in some or all 
cases may be according to the 
simplified-execution path 
definition. 

FCM) Execution is provided in the 
interpretive-execution mode, 
subject to methods of operation 
described in this section. 

x This is the only virtual- 
machine assist provided in the 
interpretive-execution mode. 



storage mode only. The simplified 
execution path is provided when the full 
function is not provided. It depends on 
the model whether, and under what 
circumstances, the full function, rather 
than the simplified execution path, is 
provided. 

The VM/370 assists for the extensions 
are not provided in the interpretive- 
execution mode. 

Page-Fault Assi st : This function is 
optionally provided in the 
interpretive-execution mode, though 
possibly only in certain circumstances, 
such as only for the preferred-storage 
mode. Bit 13 of control register is 
ignored when the function is not 
provided. It depends on the model 
whether, and under what circumstances, 
the function is provided. 



The VM/370 assist 
not provided in 
execution mode. 



for this function is 
the interpretive- 



Handling of System/370 Extended Facility 



ADD FRR : This function is provided in 
the interpretive-execution mode when the 
function is provided by the native 
machine, that is, by the machine when it 
is not in interpretive-execution mode. 
It depends on the model whether this 
function is provided in the 
interpretive-execution mode when the 
function is not provided by the native 
machine. 

The VM/370 assist for this function is 
not provided in the interpretive- 
execution mode. 



The following considerations apply 
the interpretation of this facility: 



in 



The foui — bit number from bit posi- 
tions 12-15 of the halfword at 
location 414 hex is placed in the 
channei-set-number field of the 
trace-table entry for TRACE I/O 
INTERRUPTION when the instruction 
is executed in the interpretive- 
execution mode. 

The extended-faci ii ty-trace in- 
structions obtain the value used as 
the CPU address from logical 
address 31B hex in the 
interpretive-execution mode. 



Dual- Address-Space C DAS ) Faci li tv : DAS 
is provided in the interpretive- 
execution mode. The VM/370 assist for 
this function is not provided in the 
interpretive-execution mode. 



PREFERRED-MACHINE ASSIST 



The preferred-machine-assist facility is 
not provided in the interpretive- 
execution mode. The operation code E616 
hex causes an operation exception to be 
recognized. 



3033 EXTENSION FEATURE 



SVC ASSIST and FIX PAGE : The extensions 
to these functions are optionally 
provided in full in the interpretive- 
execution mode. The full function may 
be provided only in certain circum- 
stances, such as for the preferred- 



OPTIONAL IMPLEMENTATIONS 



It depends on the model whether optional 
functions, and assists for which simpli- 
fied execution paths are available, are 
provided in full in the interpretive- 
execution mode. Functions may be 
provided in full, for example, only in 
the preferred-storage mode. 
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codeU4 instruction 12 

code 08 program interruption 12 

code 12 instruction and program 12 

code 16 external request 12 

code 20 external interruption 12 

code 24 I/O request 12 

code 28 wait state 12 

code 32 validity 13 

code 40 stop request 13 

code 44 operation exception 13 

conditional 10 

controls (IC) 11 

external request 7 

I/O request 7 

LCTL 11 

mandatory, program interruptions 12 

stop request 7 

SVC controls 10 

validity 13 
interception status (F) 14 
interlock (K) control 16 
interlock control (I), RCP byte 19 
interlocked update 

intervention requests 7 

state description fields 5 

TCH control 16 
interruption parameters 16 
interval timer 10 

activation 8 

interruption request 7 

residue counter 9 
intervention requests (V) 7 

inspection 7 

periodic inspection 7 
IPA (instruction parameter A) 14 
IPB (instruction parameter B) 15 
IPC (instruction parameter C) 15 
IPTE 15 

broadcasting 15 

interlock (K) control 16 



G 

GR 14 and GR 15 (general registers 14 

and 15) 9 
guest, definition 1 



K 

K, interlock control 16 
key handling, summary 1 



u 

host 

definition 1 
timing facilities 



last-host-CPU-address 14 

LCTL (LOAD CONTROL) interception 



11 



IC, interception controls 11 
i nspecti on 

intervention requests (V) 7 
period (polling interval) 7 
instruction fetch (IF), PER 14 
instruction parameter A (IPA) 14 
instruction parameter B (IPB) 15 
instruction parameter C (IPC) 15 
instructions, interceptible 21 
interception 11 



M 

machine check 22 

main storage 

extent 8 

guest 17 

origin 8 
mode 

pageable- storage 

prefer red- storage 

System/370 8 

370-XA 8 
mode controls (M) 8 



25 



modes, pageable-storage and 

preferred-storage, definition 1 
multiprocessing 8 

clocks 9 

summary 2 
MVS assists 22 





origin, main-storage 8 



P 

page-fault assist 23 
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